Inside Macintosh: QuickDraw GX Printing Extensions and Drivers /

Chapter 5 - Printing Functions for Message Overrides / Printing Functions Reference

Functions / Storing and Accessing Desktop Printer Data

GXWriteDTPData

You can use the GXWriteDTPData function to store data in a desktop printer.

OSErr GXWriteDTPData (Str31 dtpName, OSType theType,
                      short theID, Handle theData);

dtpName

The name of the desktop printer in which the data is to be stored.

theType

The type of the data that you are storing.

theID

The ID of the data that you are storing.

theData

A handle to the data.

function result

An error code. The value noErr indicates that the operation was successful.

DESCRIPTION

The GXWriteDTPData function stores data in the desktop printer.

You supply the name of the printer in the dtpName parameter, the type in the theType parameter, and the ID in the theID paramter. GXWriteDTPData copies the data from the handle specified by the theData parameter.

You must call the DisposeHandle function on the handle after calling this function.

RESULT CODES

gxSegmentLoadFailedErr	A required code segment could not be found, or there was not enough memory to load it.
gxPrUserAbortErr	The user has canceled printing.

SEE ALSO

You can find an example of using the GXWriteDTPData function in Listing 3-9 on page 3-31 in the chapter "Printer Drivers."

The DisposeHandle function is described in Inside Macintosh: Memory.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help